\documentclass[a4paper]{article}

\usepackage[basque]{babel}
\usepackage{verbatim}
\usepackage{html}

\begin{document}
\title{Torii editore, mihiztatzaile eta simulatzailea}
\author{Ander Martinez, EHU}
\maketitle
\tableofcontents

\section{sarrera}
Aurreko txori mihiztadura hizkuntzaren mihiztatzailea eta bird makinaren
simuladorea, hainbat eragozpen zituen, besteak beste windows familiako
sistema erabile batzuetan bakarrik ibiltzeko aukera.

Bai beste familia batzuetako sistema eragile batzuen gainean 
(Unix motakoetan) eta windows familiako sistema berrietan 
(Windows Vista) ibiltzeko aukera duen tresna berria garatzea zen 
\emph{torii}-ren xedea.

\section{Instalabidea}
\subsection{Dependentziak}
\emph{Torii}-k hainbat dependentzia ditu funtzionatu ahal izateko:
\begin{description}
\item[Python 2.x] \emph{Torii} python programazio hizkuntzan garatua izanik,
 python interpretatzaile bat (CPython) ezinbestekoa du funtzionatu 
 ahal izateko. Egungo \emph{GNU/Linux} banaketa gehienek instalatuta
 dakarte eta beste sistema eragileetan neke handirik gabe instala 
 daiteke. \emph{Torii}-k 2.x bertsio bat behar du.
\item[GTK+] X serbitzariaren gaineko toolkit erabilienetakoa Qt-rekin
 batera. X-serbitzaria ibiltzen ez duten sistema eragileetan ere
 ibiltzen da (Windows eta Mac OS).
\item[PyGTK] GTK+-rako python \emph{wrapper}-ak.
\item[gnome-python-extras] GTKSourceView pythonetik erabili ahal izateko.
\end{description}
\subsubsection{GNU/Linux-en instalatu}
Zure banaketak halakorik badu hurrengo paketeak instalatzearekin nahikoa
litzateke: python, gtk, pygtk, gnome-python-extras.
\emph{gnome-python-extras} paketeak dependentziatzat dituenez besteak
nahikoa litzateke hau instalatzea besteak instalatzeko. Adibide bezala
\emph{apt-get} erabiltzen duten sistemetan:
\begin{verbatim}
sudo apt-get install gnome-python-extras
\end{verbatim}
egingo genuke. Prozesua antzekoa da \emph{yum}, \emph{emerge}, 
\emph{pacman} eta besteekin.

\subsubsection{Windows-en instalatu}
Windows-en instalatzeko hainbat gauza instalatu behar dira.

\subsection{Kodea lortu}
Kodea banatutako .tgz fitxategi batetan jaitsi edo azken bertsioa
errepositoriotik lortu dezakezu. Horretarako
\begin{verbatim}
svn checkout http://torii.googlecode.com/svn/trunk/ torii-read-only  
\end{verbatim}

\subsection{Instalatu}
Behin dependentziak asetuta eta kodea lortuta instalatzeko nahikoa da:
\begin{verbatim}
sudo python setup.py install
\end{verbatim}
Kode banaketa sortu daiteke hurrengo aginduaz
\begin{verbatim}
python setup.py sdist
\end{verbatim}
Eta banaketa bitarra hurrengoaz
\begin{verbatim}
python setup.py bdist
\end{verbatim}
Horrela nahi bada \emph{RPM} edo Windows-erako instalatzaileak sor
daitezke.
\begin{verbatim}
python setup.py bdist --format=wininst
\end{verbatim}

\section{Erabilera}
\subsection{Erabilera grafikoa}
Instalatzaileak freedesktop.org-ek definitutako estandarrari jarraikiz
.desktop fitxategi bat jartzen du dagokion lekuan zeina menutik 
torii editorea abiaraztea ahalbidetzen duen.

Editoretik editatzen den fitxategia mihiztatu daiteke eta behin 
mihiztatuta editoretik ere simuladorea abiaraz daiteke berau 
simulatzeko.
\subsection{Komando lerrotik}
Txori lengoaiaren sintaxia definitzen duen .lang fitxategi bat ematen 
denez beste gustuko editore batekin garatu daiteke .txori kodea eta 
mihiztatu komando lerrotik. Simulatzaileak bakarrik interfaze grafikoa
du, oraingoz.
\begin{verbatim}
./torias xxx.txori
\end{verbatim}
Agindu honek \emph{xxx.txori.out} fitxategia sortuko du.

\section{Egiteke}
Oraindik gauza batzuk egiteke daude.
\begin{itemize}
\item Egoera barra konpondu.
\item Estadistikak bukatu.
\item Beste hizkuntzetara itzulpenak egin.
\end{itemize}

\section{Lizentzia eta aldaketak}
Torii-ren litzentzia GPLv2 da, beraz edozein aldaketa egin daiteke
aldaketok lizentzia berarekin argitaratzen badira. Hasierako intentzioa
ikasleek software honetan aldaketak egitea edo irakurri ahal izatea
zen, kodea guztiz euskaraz dago eta python aukeratu zen kodea 
irakurgarriagoa izateko.

Torii-ren manteinua \emph{Ander Martinez}en eskutan dago baina edozein aldaketa
egiteko baimena dezu galdetu gabe. Zure aldaketak besteentzako 
erabilgarriak direla baderitzozu bidali posta mezu bat 
\emph{dwarfnauko@gmail.com}-era eta gehituak izango dira gainbegiratu
ostean eta nahi izanez gero baimenak emango zaizkizu errepositorioan
hurrengoan zuzenean aldaketak zeuk igotzeko.

\section{Estekak}
\begin{itemize}
\item \htmladdnormallink{Toriiren aurkezpena}
    {http://oredakore.es/index.php?p=torii}
\item \htmladdnormallink{Torii projektuaren etxea Google Code-en}
    {http://code.google.com/p/torii/}
\end{itemize}
\end{document}
